Chara Sheet

SourceChara

https://docs.google.com/spreadsheets/d/1CJqsXFF2FLlpPz710oCpNFYF4W_5yoVn/edit?gid=1953808581#gid=1953808581

When making source sheets, always copy the first 3 rows from official rows and start your data at the 4th row. Do not alter the column order.

Sheet Columns

Column	Type	Description
id	string	The most important cell of an entry that distinguishes it from everything else on the Chara sheet. If the ID matches a vanilla entry's or another mod's entry's ID, the last sheet to load will override the others. This value cannot have any spaces in it, consider using snake_case style if needed, e.g. mymod_chara_yajyuu_senpai.
_id	integer	Used for sorting purposes in creature codex, can be any numeric value. This does not have to be unique.
name_JP	string	The Chara's in-name display name in Japanese.
name	string	The Chara's in-game display name in English. Other languages use SourceLocalization.json.
aka_JP	string	The Chara's in-name alias/title in Japanese.
aka	string	The Chara's in-game alias/title in English. Other languages use SourceLocalization.json.
idActor	string	Controls whether the Chara uses PCC-part rendering. Example: pcc,unique,jure loads PCC parts from pcc/unique/jure.
sort	string	Unused in SourceChara.
size	string	Tile dimensions occupied by the Chara; usually empty. Example: 2,2 makes the Chara occupy 2×2 tiles and prevents shoving.
_idRenderData	string	Controls sprite sheet referencing. chara/chara_L... uses tile IDs from tiles with textures in Texture Replace (limited slots, can be overridden). @chara uses same-ID texture from Texture (mandatory for modded Chara).
tiles	integer	tile IDs for sprite sheet, or skinset for modded Chara.
tiles_snow	integer	Replacement tile sequence when on snowy maps. Modded Chara use variation instead.
colorMod	integer	Currently mainly used with 100, allowing grayscale sprites to inherit mainElement color.
components	string	Unused in SourceChara.
defMat	string	Unused in SourceChara.
LV	integer	Chara “Danger Level”; affects spawn threshold by map danger, selection cost (slave master/animal tamer), and base stat generation from race/job characteristics.
chance	integer	Modifier for map spawn chance (and possibly sale lists). Default 100.
quality	integer	0–2: regular tiers. 3: Unique Monsters (egg obtainable; cannot befriend/capture/tame). 4: Unique Characters (only chicken eggs; can befriend but not capture/tame).
hostility	string	Temperament toward player/allies/bystanders. Blank: Hostile. Neutral: does not attack unless attacked. Friend: attacks anyone hostile to Friend units, including player if provoked.
biome	string	Increases (possibly doubles) spawn chance on specified floor type, decreases (possibly halves) on others. Example: Water strongly favors water-floor spawning.
tag	string	Known tags: mini (half sprite size), noRandomProduct (no panties from Fortune Drum; possibly no doujin), random_color (assigns hair color to grayscale regions when colorMod=100), randomFish, staticSkin (overrides gender-based sprite assignment), snow (prefers snow tiles), water (prefers water tiles).
trait	string	Complex trait list; refer to trait documentation and Trait* C# classes.
race	string	Race ID from SourceRace.
job	string	Job/class ID from SourceJob; default is none.
tactics	string	Overrides default tactics of assigned job.
aiIdle	string	AI behavior supplement/override. Examples: Stand (fully stationary, even when attacked), Root (stationary until attacked or recruited).
aiParam	string	Three values: preferred enemy distance, per-turn reposition chance to that distance, and (rarely used) bonus chance to reposition again.
actCombat	string	Active SourceElement entries usable in combat, comma-separated. Add /N for fixed use chance. For buffs, add /pt to target whole party (ally state only). Example: ActThrowPotion/30,SpWeakness,SpSpeedDown,SpWisdom/50/pt. Default chance is 100.
mainElement	string	Primary elemental affinity: Fire, Cold, Lightning, Darkness, Nether, Sound, Chaos, Poison, Cut, Acid, Impact.
elements	string	Passive SourceElement entries, comma-separated. Add /N for level/value where applicable. 0 or negative can modify inherited race elements. Examples: invisibility/1 enables, invisibility/0 disables inherited; antidote/-30 makes meat poisonous, antidote/30 cures poison or offsets racial -30.
equip	string	Overrides randomized job equipment template, only if race EQ is not empty. Example: a Thief-job unit with equip=Archer gets Archer gear; Dog-race units with empty race EQ still won’t spawn with equipment even if equip is set.
loot	string	Extra drops (Thing/ThingV IDs), comma-separated, each with /N. Every 20 = +1% drop chance. Example: medal/500 = 25%; medal/3000 = 150% (guaranteed 1 + 50% for another).
category	string	Most entries use default chara.
filter	string	Unused in SourceChara.
gachaFilter	string	Gacha picks a category (e.g., resident/livestock/Unique/default), then selects eligible Chara by this filter. Example: livestock results only include entries tagged for livestock.
tone	string	Dialogue modifiers for Japanese text.
actIdle	string	Out-of-combat behavior instructions. Examples: readBook (generates/reads/removes random book), buffMage (periodically casts buffs like spResElement or spHero).
lightData	string	Unused in SourceChara. The color emitted from light.
idExtra	string	Unused in SourceChara. Extra renderdata.
bio	string	Slash-separated values (no spaces): gender (m/f/n, required), age (optional), height (optional), weight (optional), tone from chara_tone.xlsx (optional), talk from chara_talk.xlsx (optional). Example: f/51044/152/46/friendly|私|あなた.
faith	string	Fixed religion. Setting this will prevent changing in game.
works	string	Alias from SourceHobby.
hobbies	string	Alias from SourceHobby.
idText	string	Links to an entry in CharaText sheet.
moveAnime	string	Move animation type. hop or blank.
factory	string	Unused in SourceChara.
components	string	Unused in SourceChara; This is a duplicate column.
recruitItems	string	Special recruit dialog items, only used by mani right now.
detail_JP	string	Unused in SourceChara; can be used for notes.
detail	string	Unused in SourceChara; can be used for notes.

Allow Human Speak

To allow your character to talk without parentheses, you can add tag humanSpeak in SourceChara sheet. Alternatively you can add tag human or humanSpeak in the SourceRace sheet.

Spawn Setting

We use tag column to define a Chara's spawn settings.

Migrating From CWL

CWL specs are removed from the wiki, but they are still compatible. We recommend switching to the new format.

Possible tag actions:

• addZone(zoneId@level)
• addEq(ItemId#Rarity) / addEquipment(ItemId#Rarity)
• addThing(ItemId#Count)
• addFlag(FlagName) / addInt(FlagName=1)
• addFlagValue(FlagName=some_value) / addStr(FlagName=some_value)
• addBio(BioFileId) / addBiography(BioFileId)
• addStock(StockFileId)
• addDrama(DramaFileId)

Zone Spawn

To spawn the character to a zone, add tag addZone(*) to the SourceChara row and replace the * (asterisk) with zone id or keep the asterisk for a random zone. You may also specify zone level with @n.

For example, to spawn the chara in little garden, use addZone(little_garden). To also spawn in derphy underground, use another tag addZone(derphy@-1). Check the SourceGame/Zone and reference the id column.

For each addZone tag used, an instance of the Chara will be spawned there. For example, addZone(lumiest),addZone(little_garden),addZone(specwing),addZone(*) will make sure all three selected zones plus a random zone will have this character spawned (as duplicates).

Add Equipment/Thing

When spawning your character, you may also define the starting equipments and things for this character.

To assign specific equipment to the character, use tag addEq(ItemID#Rarity) or addEquipment(ItemID#Rarity), where ItemID is replaced by the item's ID, and Rarity being one of the following: Random, Crude, Normal, Superior, Legendary, Mythical, Artifact. If #Rarity is omitted, the default rarity #Random will be used.

The rarity text in game is displayed as: Crude, Normal, Good, Miracle, Godly, Special

For example, to set a miracle BS_Flydragonsword and a random axe_machine as the main weapons for the character:

addEq(BS_Flydragonsword#Legendary),addEq(axe_machine)

To add starting items to the character, use tag addThing(ItemID#Count). If #Count is omitted, a default of 1 item will be generated.

For example, to add padoru_gift x10 and scroll of ally x5 to the character:

addThing(padoru_gift#10),addThing(1174#5)

Remember, tags are separated by , (comma) with no spaces in between.

Adventurer

Migrating From CWL

CWL specs used AdventurerBacker, which will still function the same as before. We recommend switching to the new format.

If your character has trait AdventurerCustom, the character will be imported as an adventurer, which will appear on the adventurer ranking list.

Merchant Stock

You can define a custom merchant stock using tag addStock and a simple JSON file placed in your LangMod/**/Data/ folder, with the name stock_ID.json. The ID is the unique identifier for this stock file or character. For example: stock_my_cnpc_id.json or stock_unique_armor.json.

When using the addStock tag without specifying ID, it will default to the character ID. You may also specify and/or combine multiple stock files using multiple tags, such as: addStock,addStock(unique_items),addStock(unique_armor).

Stock File

Within the stock JSON file, the structure is as follows:

{
  "Items": [
    {
      "Id": "example_item",
      "Material": "",
      "Num": 1,
      "Restock": true,
      "Type": "Item",
      "Rarity": "Random",
      "IdentifyLevel": "Identified"
    },
    {
      "Id": "example_item_limited",
      "Material": "granite",
      "Num": 1,
      "Restock": false,
      "Type": "Item",
      "Rarity": "Artifact",
      "IdentifyLevel": "Identified"
    },
    {
      "Id": "example_item_craftable",
      "Material": "",
      "Num": 1,
      "Restock": false,
      "Type": "Recipe",
      "Rarity": "Random",
      "IdentifyLevel": "Identified"
    },
    {
      "Id": "SpShutterHex",
      "Num": 5,
      "Type": "Spell"
    }
  ]
}

• Items is an array of items in the stock.
• Id
  The ID of the item (Thing). This field is required.
  For some stock types, this can be an alias of an element or a numeric ID, or a name.
• Material
  The material the item is made of. Leave it blank to use the default material defined in the Thing data.
  Default value: ""
• Num
  The number of items.
  Default value: 1
• Restock
  Determines whether the item restocks.
  Set to false for limited items that can only be purchased once.
  Default value: true
• Type See the type description table below.
• Rarity
  Possible values: Random, Crude, Normal, Superior, Legendary, Mythical, Artifact
  Default value: Normal
• IdentifyLevel
  Determines the initial identification state of the item.
  Possible values: Identified, RequireSuperiorIdentify, KnowQuality, Unknown
  Default value: Identified
• BlessedState
  Determines the blessed state of the item.
  Possible values: Doomed, Cursed, Normal, Blessed
  Default value: Normal
• NoCopy
  Cannot by copied.
  Default value: false
• NoRandomSocket
  Does not generate random ranged gun sockets.
  Default value: false
• Sockets
  List of ranged gun enchant aliases to attach as socket. Empty string for empty socket.
• PriceCalc
  Arithmetic calc expression to override the item price.
  Arguments: base (base price), lv (item level), rarity (item rarity)
  Example: "base * 0.2 + lv * 5"
• MapStr
  Additional mapStr values to merge into the item after creation.
• MapInt
  Additional mapInt values to merge into the item after creation.
• You can omit any fields to use their default values.

Stock Item Types

Type	Description
Item	A standard item. Supports material, level, and stack count.
Block	A placeable block item created from a block alias and material.
Cassette	A music cassette. If the bgm id is invalid, a random track will be used.
Currency	Currency item. Id can be money money2 plat medal influence casino_coin ecopo. Num defines the amount.
Category	Spawn from category. Id is the category name.
Filter	Spawn from filter. Id is the filter name.
Tag	Spawn from tag. Id is the tag name.
Letter	A letter item. Id is the txt id in LangMod/XX/Text/Scroll.
Perfume	A perfume. Id is the element alias or id.
Plan	A plan. Id is the element alias or id.
Potion	A potion item. Id is the element alias or id. Num defines stack size.
Recipe	A recipe item for crafting.
RedBook	A red book item. Id is the txt id in LangMod/XX/Text/Book.
Rod	A rod item. Id is the element alias or id. Num defines charges.
Rune	A rune item. Id is the element alias or id.
RuneFree	A lawless rune item. Id is the element alias or id.
Scroll	A scroll item. Id is the element alias or id.
Skill	A skill book. Id is the element alias or id.
Spell	A spell book. Id is the element alias or id. Num defines the charge.
Usuihon	A special item. Id is the religion id.

If you are not using a code editor, you can use JSONLint to validate your JSON.

Talk & Popups

Barks (Popup)

Sometimes you want the character to banter/bark at certain conditions. The barks pop up above character's head in a speech bubble.

These barks are written in CharaText sheet, and your Chara sheet uses idText cell to link their IDs together.

Column	Condition
calm	Idle default
fov	On sight
aggro	In combat
dead	Death rattle
kill	Kill confirmed

Let's Talk

To add some chatty texts to the character for the Let's Talk option, you'll need to use dialog.xlsx file placed in your LangMod/**/Dialog/ folder.

Let's talk texts are line-separated texts in unique sheet and a row with your character's ID.

Format

The data starts at the 5th row.

You can reference the game's dialog sheet at Elin/Package/_Elona/Lang/_Dialog/dialog.xlsx.

Drama

A drama is the rich dialog that usually has options and additional actions.

Drama guides are moved to their new section for now:

Drama System

/10_Source Sheets/drama.md

Biography

To add more flavor to your character, you may use tag addBio(ID) to define a custom biography. The bio file is (yet another) json file placed in your LangMod/**/Data/ folder, with name bio_ID.json, the ID is the unique ID for this biography file, such as bio_my_chara.json.

You may reuse the same biography file for multiple characters by specifying the same ID.

Within the bio file, it's simply as follows:

{
    "BirthDay": 11,
    "BirthMonth": 4,
    "BirthYear": 514,
    "BirthPlace": "Earth",
    "BirthLocation": "",
    "Mom": "Best Mom",
    "Dad": "Best Dad",
    "Background": "An absolutely normal living been\nBut on ylva...",
    "FavFood": "mushroom_rare",
    "FavCategory": "mushroom",
    "LikeThing": "stethoscope",
    "LikeHobby": "martial"
}

• FavFood: Thing/ThingV/Food id.
• FavCategory: Category id.
• LikeThing: Thing/ThingV/Food id.
• LikeHobby: Element alias.

If you are not using a code editor, you can use JSONLint to validate your JSON.

Portrait and Sprite

Portrait

Portraits, also known as character art (tachie), are the images displayed on the left side of the popup dialog when conversing with a character.

Portraits should be placed in the Portrait folder, and this Portrait folder should be located within your mod package.

For more detailed information regarding portraits, please proceed to Portraits and read the portrait section for character mods.

Texture (Sprite)

The texture of a character on the map is more accurately described as a Sprite.

A character sprite is a .png image with a transparent background, which should be placed in the Texture folder. The Texture folder should be located in your Game Installation Directory/Elin/Package/Your Custom Mod Folder Name (where Your Custom Mod Folder Name is your mod package).

You can also utilize animated sprites, larger canvas sizes, and sprite variants that change depending on different conditions.

For further details, please navigate to the Texture Mods section in the main directory.

Examples

For portraits and sprites, you can refer to the Tiny Mita example:

CWL Example: Tiny Mita

https://steamcommunity.com/sharedfiles/filedetails/?id=3396774199